home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / archiver / extar10.zip / EXTAR.DOC next >
Text File  |  1991-06-08  |  3KB  |  71 lines
  1.  
  2.                              E x T A R  1.0
  3.                              ==============
  4.  
  5.                              February 1990
  6.  
  7.                Free Software by TapirSoft Gisbert W.Selke
  8.  
  9.  
  10. On Unix machines, probably the most common way of bundling a set of
  11. files (for purposes of mailing or whatever) is to put them into a TAR
  12. file, i.e., a Tape ARchive, conventionally recognizable by a name
  13. ending in .tar. (These TAR files are then usually compressed,
  14. recognizable by a file name ending in .tar.Z. But this is an entirely
  15. different story that we won't discuss here.)
  16.  
  17. Occasionally, one gets a TAR on an MS-DOS machine and would like to
  18. extract some, or all, of its members; and in fact, there are a number of
  19. programmes around that list TAR contents, extract from them and even
  20. build new ones. So far, so good; but they -- at least the ones I have
  21. encountered so far -- don't cater for file names which are perfectly
  22. valid under Unix but are illegal under MS-DOS. E.g., file names could
  23. contain multiple periods, start with a period, or contain all sorts of
  24. nasty characters that are interpreted as delimiters by DOS or are
  25. not permitted for some reason or other. Trying to extract those files
  26. will just fail. Also, Unix file names are case-sensitive -- hence, a TAR
  27. might contain read.me and READ.ME (and possibly Read.Me). For DOS, these
  28. all look the same; hence, extracting one of them will overwrite the
  29. others that have the 'same' name.
  30.  
  31. Hence I wrote ExTAR, which is a very crude, no-frills utility with one
  32. purpose only: extract all members of a TAR, creating directories as
  33. necessary, and renaming files to make them acceptable to DOS; all the
  34. time taking care not to overwrite any existing files. It does so by
  35. truncating names and converting offending ones to nice ones. Exactly
  36. what it does is shown on the screen; if you need to save this
  37. information, you'd better write them down while they zip by, or maybe
  38. redirect all these messages to some log file.
  39.  
  40. Usage is simple:
  41.           extar    filename
  42. is all there is to it. (You may omit the extension .TAR, which is
  43. added automatically iff the filename contains no period.) Files are
  44. written to the current directory; subdirectories are created as
  45. necessary. If a file of the 'same' name already exists, the user is
  46. asked if overwriting is OK; if not, the name is mangled some more to
  47. make it unique.
  48.  
  49. ExTAR does not do any of the fine things the other TAR processors do; in
  50. particular, it does no listing of contents and no error checking. Also,
  51. since I don't have any official documentation of the TAR format, I may
  52. have overlooked certain special features embedded into some... I don't
  53. know, and frankly, I don't care too much. So let's leave it this way:
  54. this is free software, supplied as-is, no guarantees for anything.
  55. Source (TurboPascal 5.5+) is provided; if it doesn't suit your needs,
  56. feel free to hack it. Just give credit where credit is due, and don't
  57. you sell my product; rather, if you think others might like your stuff,
  58. give it to them like I do. (Hey, even I might be interested!) -- If, on
  59. the other hand, you have a plain simple TAR containing a file name that
  60. ExTAR chokes on, I just might be interested in fixing it myself.
  61. Describe it to me, or better yet, send me a copy of the TAR.
  62.  
  63. Enjoy.
  64.  
  65. TapirSoft
  66. Gisbert W.Selke           <s00100@dbnrhrz1.bitnet>
  67. Ermekeilstrasse 28
  68. D-5300 Bonn 1
  69. Germany
  70.  
  71.